fix(DApplication): wire up applicationHomePage in about dialog - #778

背景

DApplication::handleAboutAction() 在自动创建关于对话框时，只设置了 productName / productIcon / version / description / license / acknowledgement，未调用 DAboutDialog::setWebsiteName / setWebsiteLink，导致应用无法自定义网站行，始终回退到发行版默认值。

根因

• DAboutDialog 本身已具备 setWebsiteName() / setWebsiteLink() 能力，但 DApplication 的自动创建路径没有接线。
• DApplication 已有 applicationHomePage / setApplicationHomePage 属性，文档明确写着「主要用于在关于对话框中进行展示」，但该属性从未被 handleAboutAction() 读取，属于遗留死 API。

方案（采用 DDE Architect 推荐方案）

复用遗留的 applicationHomePage（作为 link 源），并新增 applicationWebsiteName（作为展示名称）：

改动文件

1. include/widgets/dapplication.h

   • 新增 Q_PROPERTY(QString applicationHomePage ...)（补齐元对象一致性）
   • 新增 Q_PROPERTY(QString applicationWebsiteName ...)
   • 新增 applicationWebsiteName() / setApplicationWebsiteName() 声明

2. src/widgets/dapplication.cpp

   • 实现 applicationWebsiteName() / setApplicationWebsiteName()（读写 d->websiteName）
   • 在 handleAboutAction() 自动建对话框段落，设置完 acknowledgement 后、setAttribute(WA_DeleteOnClose) 前，按「非空才覆盖」插入：

     if (!applicationHomePage().isEmpty())
         aboutDialog->setWebsiteLink(applicationHomePage());
     if (!applicationWebsiteName().isEmpty())
         aboutDialog->setWebsiteName(applicationWebsiteName());

3. src/widgets/private/dapplication_p.h

   • 新增成员 QString websiteName;

4. CHANGELOG.md

   • Added: applicationWebsiteName 属性
   • Changed: applicationHomePage 现生效于关于对话框

向后兼容

• 纯增量 API：新增 applicationWebsiteName getter/setter 与 Q_PROPERTY，以及为 applicationHomePage 补 Q_PROPERTY，均为源码/二进制兼容的加法（DTK6 SONAME 线内）。
• 默认行为不变：当开发者未设 applicationHomePage 和 applicationWebsiteName 时，两个 if (!...isEmpty()) 均不触发，对话框仍显示发行版默认网站。
• applicationHomePage 从死代码变为生效：变更方向符合其文档一直承诺的用途；唯一受影响的是「调用了 setApplicationHomePage 却期望它什么都不做」的极端组合，实际中几乎不存在。
• 自定义对话框路径不受影响：经 setAboutDialog() 传入的对话框不走新逻辑。
• 无需 DTK 版本守卫：DTK6 线的新增特性。

测试建议

新增用例覆盖 4 个组合：

• (name, link) 均空 → 显示发行版默认
• 仅 link → link 自定义、名称为发行版默认
• 仅 name → 名称自定义、link 为发行版默认
• 均设 → 均为自定义值

并回归：

• 不设任何值时仍显示发行版默认
• setAboutDialog 自定义对话框不受影响

关联

• Issue: DDE-211
• 技术方案：DDE Architect

Summary by Sourcery

Display customized application homepage links and names in automatically generated about dialogs while preserving distribution defaults when no homepage is configured.

Bug Fixes:

• Wire applicationHomePage into automatically generated about dialogs so custom homepage links are displayed instead of always using the distribution default website.

Enhancements:

• Derive the displayed website name from the homepage URL host, with a fallback to the original value when it cannot be parsed.

Documentation:

• Document that applicationHomePage controls the about dialog homepage link and displayed name.